home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / Text and Speech / TextMaster 1.4 / Read Me next >
Text File  |  1991-05-13  |  4KB  |  93 lines
  1.  
  2.                           TextMaster -- Version 1.4
  3.  
  4. By: Donald Burr
  5.     INTERNET: dburr@ocf.berkeley.edu, 72540.3071@compuserve.COM
  6.     Compu$erve: 72540,3071         America Online: DonaldBurr
  7.  
  8. This is version 1.4 of TextMaster, a UNIX- and Macintosh-end program to
  9. convert text file formats between UNIX, Macintosh, and IBM.
  10.  
  11. This release fixes a MAJOR bug in the Macintosh end.  The Mac end will now
  12. correctly convert files from Mac -> UNIX.
  13.  
  14. TextMaster will convert between UNIX newlines and Macintosh end-of-line
  15. characters.  The direction of conversion can be specified at the command
  16. line, and thus files can be converted in any direction.
  17.  
  18. This is useful if your UNIX -> Mac downloads, or uploads, of text files
  19. are failing miserably.  White Knight has a tendency to do this, and other
  20. comm programs may as well.
  21.  
  22. Please send all comments, bug reports, feature requests, etc. to the
  23. Internet address listed above.
  24.  
  25. This software is being donated to the public domain.  Permission is hereby
  26. granted to freely copy and distribute this source code, as long as no fees
  27. are charged for such duplication.  Permission is also granted to modify
  28. this source code at will, providing that you insert a notice in the dist-
  29. ribution that this source is NOT the original TextMaster source, and that you
  30. not remove my name from the program and accompanying documentation.
  31.  
  32. WHAT IS TEXTMASTER?
  33.  
  34.     It is a utility I hacked together to convert between Macintosh end-
  35. of line characters, and UNIX newlines.  I downloaded a mess of text files
  36. one day to my Mac, and found they all came out on one line, with weird char-
  37. acters (represented by "boxes") between where "line breaks" should have
  38. been.  Since I really couldn't download those files again, I decided to write a
  39. utility to help me convert and salvage them.  Thus was born TextMaster,
  40. which was released (up to version 1.3) as "Macify".  Since then, I have found
  41. out that there already is a product called Macify, so in this release, I change
  42. the name to TextMaster.  Nuff said.
  43.  
  44. HOW TO USE IT
  45.  
  46.     First thing you should do is upload, or somehow otherwise move the
  47. "tm14.shar" file to your UNIX system.  Run it through "/bin/sh" (the Bourne
  48. Shell) by the following command (assuming "%" represents your UNIX
  49. prompt)
  50.  
  51. % /bin/sh < tm14.shar
  52.  
  53.     This will create a number of files in your directory.  Read them, and follow
  54. their instructions, to compile the UNIX half of TextMaster.
  55.  
  56.     Simply launch the TextMaster application from the Finder.  There are only
  57. two menu choices: "Macintosh -> UNIX" and "UNIX -> Macintosh".  Choose
  58. whichever one represents the direction you want to convert things in.
  59. When you make a choice, a file dialog will appear; select the textfile you
  60. wish to convert, and click "Open".  The conversion will take place, saving
  61. the output to "filename.out" (i.e. if you opened a file called "Foo", the
  62. resultant file will be called "Foo.out").
  63.  
  64.     To find out how to use the program, as well as on how to detect what
  65. type of textfile you have, choose the "help..." menu item.
  66.  
  67. LAST WORDS
  68.  
  69.     Certainly hope you enjoy this program.  It took a bit of work, es-
  70. pecially the Mac portion of it, but I find it useful.
  71.  
  72.     I am charging no shareware fee or anything for this.  It's free.
  73. Take it, use it in good health.  Modify it at will.  However, when modify-
  74. ing the program, leave the version number intact; just tack on your own
  75. version number after mine.  Example, if the version # of TextMaster is 1.4,
  76. and your name is Bill Smith, and this is the second revision to my code
  77. you have done, change the version number to something like "1.4/BS-2",
  78. the "BS" symbolizing this is Bill Smith's version, and the '2' signifying
  79. this is Bill Smith's 2nd version.  Now you can redistribute the program;
  80. this way, we can keep track of which is the "genuine" version, and so
  81. forth.
  82.  
  83.     Two things I ask if you redistribute this work are, (a) my credit
  84. (name, copyright, etc.) MUST remain in all documentation and program
  85. displays, and (b) You not charge for distribution or shareware fees.
  86.  
  87.     Please email me with all bug reports, suggestions for changes, and
  88. so on.  Better yet, if you have a suggestion for a change or a bug fix or
  89. whatnot, and you can program in C, make the patch yourself, and mail me a
  90. copy of the resultant source code.  If it's good, and I like it, I'll be
  91. sure to include it in my next version, with your name in the credits!  My
  92. email addresses can be found at the beginning of this document.
  93.